Get Customer by ID

Retrieve a specific customer by their Stripe customer ID

Endpoint

GET /api/customers/:id

Retrieves detailed information about a specific customer using their Stripe customer ID.

Request

id · string · required

The Stripe customer ID (format: cus_...)

Response

status · boolean

Indicates if the request was successful

message · string

Response message describing the result

data · object

Complete Stripe customer object with all customer details including:

Show data properties

id · string

Unique Stripe customer ID

email · string

Customer’s email address

name · string

Customer’s full name

phone · string

Customer’s phone number

created · integer

Timestamp when the customer was created

default_source · string

ID of the customer’s default payment source

Examples

cURL

curl -X GET https://your-domain.com/api/customers/cus_1234567890abcdef \
  -H "Content-Type: application/json"

Response Examples

Success (200)

{
  "status": true,
  "message": "Cliente obtenido correctamente",
  "data": {
    "id": "cus_1234567890abcdef",
    "object": "customer",
    "email": "[e-mail]",
    "name": "John Doe",
    "phone": "[phone]",
    "created": 1234567890,
    "default_source": null,
    "balance": 0,
    "currency": "usd"
  }
}

Error (400)

{
  "status": false,
  "message": "id es requerido",
  "code": null
}

Error (404)

{
  "status": false,
  "message": "Cliente no encontrado",
  "code": "resource_missing"
}

Error (500)

{
  "status": false,
  "message": "Error interno del servidor",
  "code": null
}